home *** CD-ROM | disk | FTP | other *** search
/ Business Shareware / Business Shareware.iso / start / disk / tcpy200 / tctech.doc < prev   
Encoding:
Text File  |  1993-03-22  |  8.3 KB  |  177 lines
  1.  
  2.      TTTTT  U   U  RRRR   BBBB    OOO    CCC    OOO   PPPP   Y   Y
  3.        T    U   U  R   R  B   B  O   O  C   C  O   O  P   P  Y   Y
  4.        T    U   U  RRRR   BBBB   O   O  C      O   O  PPPP    YYYY
  5.        T    U   U  R   R  B   B  O   O  C   C  O   O  P          Y
  6.        T     UUU   R   R  BBBB    OOO    CCC    OOO   P      YYYY
  7.  
  8.  
  9.                               version 2.00
  10.  
  11.                      by Pierre J. le Riche 1991-93
  12.  
  13.               A Speedy Multi-Volume File Transfer Program
  14.  
  15.                           Technical Reference
  16.  
  17. ***************
  18. *Introduction:*
  19. ***************
  20. TurboCopy version 1.00 was completed during October 1991, since then I
  21. have constantly updated the program and added new options. TurboCopy
  22. progressed until version 1.15 when I decided a complete rewrite has
  23. become necessary. From the outset I wanted TurboCopy 2.00 to be the
  24. fastest and most versatile copy program available, and yet keep it as
  25. simple to operate as possible. I hope you will agree that I have been
  26. successful in this endeavour. To maintain high speed and small code size
  27. I have opted to write the complete package in 8088 assembly language. At
  28. the moment the source is just short of 8000 lines. I am not distributing
  29. the source code for version 2, but I will send the source for version
  30. 1.15 on request. (If you can yank my arm hard enough I might consider
  31. sending you the source for version 2, but that is only in very
  32. exceptional circumstances!)
  33.  
  34. ****************
  35. *Compatibility:*
  36. ****************
  37. TurboCopy is compatible with the xcopy command line except for the /e
  38. and /p options that have been given new meanings. TurboCopy has been
  39. tested with Christoph H. Höchstatter's FDRead and works fine. I also
  40. recommend that if you want even more speed, that you use his FDFormat
  41. program to format your floppies with sector sliding. Due to TurboCopy's
  42. internal cache, you are not allowed to TurboCopy to a phantom floppy
  43. drive B:. TurboCopy runs on any IBM compatible computer, however the
  44. cache will automatically be disabled on XTs with BIOSes dated before
  45. January 1986.
  46.  
  47. **********************
  48. *Memory requirements:*
  49. **********************
  50. TurboCopy will utilise all conventional, extended and expanded memory if
  51. it is available. For the cache to be enabled, TurboCopy requires 384K
  52. conventional memory. With the cache disabled TC can operate with as
  53. little as 72K conventional memory (104K when doing manual file
  54. selections). During a DOS shell TC will typically occupy about 20K
  55. conventional memory. Do not load any TSR programs while in a DOS shell
  56. for this will fragment your conventional memory pool, and TC will refuse
  57. to continue.
  58.  
  59. *******************
  60. *Errorlevel codes:*
  61. *******************
  62. If you want to detect any errors that may have ocurred during a
  63. file transfer fromout a batch file, you may expect one of the following
  64. return codes:
  65.         0 = No error ocurred, the copy terminated successfully
  66.         1 = The user tried a illegal combination of options, i.e.
  67.             A and m together.
  68.         2 = The user pressed break or selected "Quit" from a prompt.
  69.         3 = An error ocurred from inside the floppy disk cache.
  70.         4 = An error ocurred during memory allocation
  71.         5 = A bad or invalid source path was specified.
  72.         6 = A bad or invalid destination path was specified.
  73.         7 = TurboCopy couldn't match any files to copy.
  74.         8 = No source path specified.
  75.         9 = You tried to TurboCopy to a phantom floppy drive B:.
  76.         10 = The source contained too many files for TC to handle.
  77.         11 = The source contained too many subdirectories for TC to
  78.              handle.
  79.         12 = TC couldn't save your configuration (encountered with
  80.              TC/U).
  81.         13 = A nonexistant or corrupt list file was specified.
  82.         14 = The TC.COM file has been corrupted.
  83.  
  84. ****************
  85. *Error messages*
  86. ****************
  87. TurboCopy checks for numerous different error conditions. I have tried
  88. to make TC's error messages as informative as possible, and therefore
  89. you should not experience any trouble determining what went wrong in the
  90. event of a failed copy. For completeness I will include a list of error
  91. messages with a short discription for those that might be a bit
  92. confusing:
  93.  
  94. Unable to reclaim conventional memory.
  95.         TC will issue this error after a shell if it is unable to
  96.         reclaim the full amount of conventional memory it had before the
  97.         shell, i.e. if you loaded a TSR while in a DOS shell.
  98. Not enough space on disk for any files.
  99. Destination root directory full.
  100.         All disks have a limit to the number of files their root
  101.         directories can contain. For 360K floppies it is 112 and for
  102.         most others it is 224 (including the volume label), so if you
  103.         are out of root directory enrtries you may waste precious space
  104.         on the disk.
  105. Error writing file xxxxxxxx.xxx
  106. Error reading source
  107. Error during floppy cache writeback
  108.         This error is encountered when the floppy cache encountered an
  109.         error while doing a disk writeback and was unable to recover.
  110. Bad source file skipped.
  111.         If your source drive contained a file with a bad sector or data
  112.         error, TC will ask you whether you want to skip the bad file and
  113.         continue or if you want to quit.
  114. Sliced file will continue on next disk.
  115.         If you are busy slicing a file and TC detects that there already
  116.         exists a file with the name of the current sliced volume on the
  117.         current destination disk, and you opted to skip the file, then
  118.         TC will continue with the sliced file on the next disk.
  119. File xxxxxxxx.xxx exists. AppEnd, SkIp (all) or Overwrite (all)?
  120. Unable to create subdirectory.
  121. Unable to delete source file.
  122. Unable to reset source file's archive attribute.
  123. Unable to remove empty source directories.
  124. Unable to quickformat destination disk.
  125.         TC will only format floppy disks in drive A: or B: that meets
  126.         the following criteria: It must have two FATs, 512 byte sectors
  127.         and 12-bit FAT entries.
  128. Quickformat warning: Disk has not been changed!
  129.         If you specified the /Q option and TC prompted you for the next
  130.         floppy disk, and you pressed any key before changing the disk,
  131.         TC will display this message. It is to prevent TC from deleting
  132.         data just copied.
  133. Bad source drive 'x:'
  134. Bad destination drive 'x:'
  135. Bad source path: c:\xxxxxx\xxxxx
  136. Move operation might require more workspace.
  137.         The /X option, when the source and destination uses a minimal
  138.         amount of workspace (typically one cluster).
  139. No files to copy.
  140. Duplicate xxxxxxxx.xxx with /C option. Skip file, Ignore or Quit?
  141.         If you specifies /S and /C and TC encounters two files with
  142.         exactly the same filename, TC will display this message.
  143. Too many subdirectories.
  144. Too many files.
  145. Invalid date specified.
  146.         Dates specified with /D must be in day-month-year format.
  147. Cannot TurboCopy to/from phantom floppy drive B:.
  148.         Due to the built-in cache, TC can only copy to actual physical
  149.         drives and not substituted floppies.
  150. Bad verbosity level specified.
  151.         Verbosity levels specified with /T range from 0 to 9.
  152. A and M options may not be used together.
  153. I, E, N and O options may not be used together.
  154. Turbocopy requires xK of memory, thus you will have to free another xK.
  155. No source specified.
  156. Bad list file specified.
  157. Illegal command in list file.
  158. Destination is ambiguous. Is 'xxxxxxxx.xxx' a Directory or a File?
  159. WARNING! Insufficient conventional memory for cache.
  160.  
  161. ************
  162. *Final Note*
  163. ************
  164. If you would like any personalised changes, or you have any suggestions,
  165. feel free to contact me at the address given. If you are writing
  166. something similar, or if you are interested in obtaining some of my
  167. routines; feel free to contact me and I will send them to you (on the
  168. condition that you mention in your program where you got them). Finally,
  169. please don't hack this program into itsy little bits or edit the
  170. documentation or something equally low. I have not put any copy
  171. protection into TC, so it should not be difficult to change the program
  172. at all; so don't see it as an achievement if you manage to mess it up.
  173. Please contact me if you want any changes.
  174.  
  175. Thank you for your interest in this program.
  176.  
  177.